home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / OpenOffice.idb / usr / OpenOffice / help / en / scalc.jar / text / scalc / 01 / 04060111.xml < prev    next >
Encoding:
Extensible Markup Language  |  2002-01-24  |  11.4 KB  |  102 lines
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <html><head><title>Add-in Functions</title><meta name="filename" content="text/scalc/01/04060111"/><meta name="language" content="en-US"/><help:css-file-link xmlns:help="http://openoffice.org/2000/help"/><!--The CSS style header method for setting styles--><style type="text/css">
  3.  
  4.         table.Tabelle2{
  5.                 }
  6.         span.Tabelle2A{
  7.                 width:1.499cm;}
  8.         span.Tabelle2B{
  9.                 width:16.498cm;}
  10.         tr.Tabelle21{
  11.                 }
  12.         td.Tabelle2A1{
  13.                 }
  14.         p.P1{
  15.                 }
  16.         span.T1{
  17.                 font-weight:bold;}
  18.         span.fr1{
  19.                 }
  20.         </style></head><body>
  21.    
  22.    
  23.    <p class="P1"/>
  24.    <p class="Head1"><help:key-word value="add-in; functions" tag="kw66872_1" xmlns:help="http://openoffice.org/2000/help"/><help:key-word value="functions; add-in" tag="kw66872_11" xmlns:help="http://openoffice.org/2000/help"/><help:key-word value="categories; add-in" tag="kw66872_10" xmlns:help="http://openoffice.org/2000/help"/>Add-in Functions</p>
  25.    <p class="Paragraph"><help:to-be-embedded Eid="addintext" xmlns:help="http://openoffice.org/2000/help">Here you can use additional Add-In functions.</help:to-be-embedded></p>
  26.    <help:popup Id="66774" Eid="addin" xmlns:help="http://openoffice.org/2000/help"><help:embedded Id="66778" Eid="wie"/></help:popup>
  27.    <p class="Paragraph"><help:link Id="66914" xmlns:help="http://openoffice.org/2000/help">AddIn concept</help:link></p>
  28.    <p class="Paragraph"/>
  29.    <p class="Paragraph">You will also find a<help:link Id="66914" xmlns:help="http://openoffice.org/2000/help">description of the <help:productname>%PRODUCTNAME</help:productname> Calc-AddIn-Interface</help:link> in the Help. In addition, important functions and their parameters are described in the Help for the <help:switch select="System" xmlns:help="http://openoffice.org/2000/help"><help:case select="UNIX">Shared Library</help:case><help:default><help:productname>%PRODUCTNAME</help:productname> Calc-Add-In-DLL</help:default></help:switch>.</p>
  30.    <p class="Head2"><a name="beispiele"/>AddInns supplied</p>
  31.    <p class="Paragraph"><help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> contains examples for the AddIn interface of <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> Calc. If you have installed AddIns, they are located in {installpath}/program/addin <help:switch select="System" xmlns:help="http://openoffice.org/2000/help"><help:case select="UNIX">Shared Libraries</help:case><help:default>DLLs</help:default></help:switch>. These provide the functions that you find in AutoPilot: Functions under the <span class="T1">AddIn</span> category.</p>
  32.    <p class="Paragraph"><help:link Id="68333" xmlns:help="http://openoffice.org/2000/help">Analysis Functions Part One</help:link></p>
  33.    <p class="Paragraph"><help:link Id="68331" xmlns:help="http://openoffice.org/2000/help">Analysis Functions Part Two</help:link></p>
  34.    <p class="Paragraph">Furthermore, a folder named "source" is found under the Add-In directory. This folder contains the source code for the <help:switch select="System" xmlns:help="http://openoffice.org/2000/help"><help:case select="UNIX">Shared Libraries</help:case><help:default>DLLs</help:default></help:switch> and provides interesting programming examples in an overview of the Add-In-<help:switch select="System" xmlns:help="http://openoffice.org/2000/help"><help:case select="UNIX">Shared Library</help:case><help:default>DLL</help:default></help:switch> functions.</p>
  35.    <p class="Paragraph">The "Rot*.<help:switch select="System" xmlns:help="http://openoffice.org/2000/help"><help:case select="UNIX">SO</help:case><help:default>DLL</help:default></help:switch>" provides an encryption function called <help:link Id="66872" Eid="rot13" xmlns:help="http://openoffice.org/2000/help">ROT13</help:link>, which is based on a simple algorithm.</p>
  36.    <p class="Paragraph">"Dfa*.<help:switch select="System" xmlns:help="http://openoffice.org/2000/help"><help:case select="UNIX">SO</help:case><help:default>DLL</help:default></help:switch>" provides additional date functions: <help:link Id="66872" Eid="istschaltjahr" xmlns:help="http://openoffice.org/2000/help">ISLEAPYEAR</help:link>, <help:link Id="66872" Eid="jahre" xmlns:help="http://openoffice.org/2000/help">YEARS</help:link>, <help:link Id="66872" Eid="monate" xmlns:help="http://openoffice.org/2000/help">MONTHS</help:link>, <help:link Id="66872" Eid="tageimjahr" xmlns:help="http://openoffice.org/2000/help">DAYSINYEAR</help:link>, <help:link Id="66872" Eid="tageimmonat" xmlns:help="http://openoffice.org/2000/help">DAYSINMONTH</help:link>, <help:link Id="66872" Eid="wochen" xmlns:help="http://openoffice.org/2000/help">WEEKS</help:link>, <help:link Id="66872" Eid="wochenimjahr" xmlns:help="http://openoffice.org/2000/help">WEEKSINYEAR</help:link>.</p>
  37.    <table><tr class="Tabelle21"><th class="Tabelle2A1" style="text-align:left;"><span class="Tabelle2A">
  38.        <p class="Paragraph"><draw:image draw:style-name="fr1" draw:name="HIND_2" text:anchor-type="paragraph" svg:width="0.847cm" svg:height="0.847cm" draw:z-index="0" xlink:href="65980" xlink:type="simple" xlink:show="embed" xlink:actuate="onLoad" draw:filter-name="GIF - Graphics Interchange" xmlns:draw="http://openoffice.org/2000/drawing" xmlns:text="http://openoffice.org/2000/text" xmlns:svg="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"/></p>
  39.       </span></th><th class="Tabelle2A1" style="text-align:left;"><span class="Tabelle2B">
  40.        <p class="Paragraph">You can only use the available "Dfa*.<help:switch select="System" xmlns:help="http://openoffice.org/2000/help"><help:case select="UNIX">SO</help:case><help:default>DLL</help:default></help:switch>" functions when under <span class="T1">Tools - Options - Spreadsheet - Calculate</span> in the <span class="T1">Date</span> section the <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> default setting with 12/30/1899 as the starting point on the timeline has been activated. Pay attention to how to <help:link Id="66874" Eid="date" xmlns:help="http://openoffice.org/2000/help">enter dates</help:link> as well.</p>
  41.       </span></th></tr></table>
  42.    <p class="Paragraph"/>
  43.    <p class="Head2"><a name="istschaltjahr"/><help:key-word value="ISLEAPYEAR" tag="kw66872_9" xmlns:help="http://openoffice.org/2000/help"/>ISLEAPYEAR</p>
  44.    <p class="Paragraph">Determines whether a year is a leap year. If yes, the function will return the value 1 (TRUE); if not, it will return 0 (FALSE).</p>
  45.    <p class="Head3">Syntax</p>
  46.    <p class="Paragraph">ISLEAPYEAR(Date)</p>
  47.    <p class="Paragraph">Date: Specifies whether a given date falls within a leap year.</p>
  48.    <p class="Head3">Example</p>
  49.    <p class="Paragraph">ISLEAPYEAR(29.02.68) returns 1.</p>
  50.    <p class="Head2"><a name="jahre"/><help:key-word value="YEARS" tag="kw66872_8" xmlns:help="http://openoffice.org/2000/help"/>YEARS</p>
  51.    <p class="Paragraph">Calculates the difference in years between two dates.</p>
  52.    <p class="Head3">Syntax</p>
  53.    <p class="Paragraph">YEARS(Date1, Date2, Type)</p>
  54.    <p class="Paragraph">Date1: First date</p>
  55.    <p class="Paragraph">Date2: Second date</p>
  56.    <p class="Paragraph">Type: Calculates the type of difference. Possible values are 0 (Interval) and 1 (in calendar years).</p>
  57.    <p class="Head2"><a name="monate"/><help:key-word value="MONTHS" tag="kw66872_7" xmlns:help="http://openoffice.org/2000/help"/>MONTHS</p>
  58.    <p class="Paragraph">Calculates the difference in months between two dates.</p>
  59.    <p class="Head3">Syntax</p>
  60.    <p class="Paragraph">MONTHS(Date1, Date2, Type)</p>
  61.    <p class="Paragraph">Date1: First date</p>
  62.    <p class="Paragraph">Date2: Second date</p>
  63.    <p class="Paragraph">Type: Calculates the type of difference. Possible values include 0 (Interval) and 1 (in calendar months).</p>
  64.    <p class="Head2"><a name="rot13"/><help:key-word value="ROT13" tag="kw66872_6" xmlns:help="http://openoffice.org/2000/help"/>ROT13</p>
  65.    <p class="Paragraph">Encrypts a character string by moving the characters 13 positions in the alphabet. After the letter Z, the alphabet begins again (Rotation). By applying the encryption function again to the resulting code, you can decrypt the text.</p>
  66.    <p class="Head3">Syntax</p>
  67.    <p class="Paragraph">ROT13(Text)</p>
  68.    <p class="Paragraph">Text: Enter the character string to be encrypted. ROT13(ROT13(Text)) decrypts the Code.</p>
  69.    <p class="Head3">Examples</p>
  70.    <p class="Paragraph">ROT13("This is a secret code") returns "Qnf vfg rva trurvzre Pbqr".</p>
  71.    <p class="Paragraph">ROT13("Qnf jne rva trurvzre Pbqr") returns "This was a secret code".</p>
  72.    <p class="Head2"><a name="tageimjahr"/><help:key-word value="DAYSINYEAR" tag="kw66872_5" xmlns:help="http://openoffice.org/2000/help"/>DAYSINYEAR</p>
  73.    <p class="Paragraph">Calculates the number of days in the year until a given date.</p>
  74.    <p class="Head3">Syntax</p>
  75.    <p class="Paragraph">DAYSINYEAR(Date)</p>
  76.    <p class="Paragraph">Date: The date until which a number of days in the year will be calculated.</p>
  77.    <p class="Head3">Example</p>
  78.    <p class="Paragraph">DAYSINYEAR(29.02.68) returns 366 days.</p>
  79.    <p class="Head2"><a name="tageimmonat"/><help:key-word value="DAYSINMONTH" tag="kw66872_4" xmlns:help="http://openoffice.org/2000/help"/>DAYSINMONTH</p>
  80.    <p class="Paragraph">Calculates the number of days in a month until a certain date.</p>
  81.    <p class="Head3">Syntax</p>
  82.    <p class="Paragraph">DAYSINMONTH(Date)</p>
  83.    <p class="Paragraph">Date: The date until which the days in the month will be calculated.</p>
  84.    <p class="Head3">Example</p>
  85.    <p class="Paragraph">DAYSINMONTH(17.02.68) returns 29 days.</p>
  86.    <p class="Head2"><a name="wochen"/><help:key-word value="WEEKS" tag="kw66872_3" xmlns:help="http://openoffice.org/2000/help"/>WEEKS</p>
  87.    <p class="Paragraph">Calculates the difference in weeks between two dates.</p>
  88.    <p class="Head3">Syntax</p>
  89.    <p class="Paragraph">WEEKS(Date1, Date2, Type)</p>
  90.    <p class="Paragraph">Date1: First date</p>
  91.    <p class="Paragraph">Date2: Second date</p>
  92.    <p class="Paragraph">Type: Calculates the type of difference. The possible values are 0 (interval) and 1 (in numbers of weeks).</p>
  93.    <p class="Head2"><a name="wochenimjahr"/><help:key-word value="WEEKSINYEAR" tag="kw66872_2" xmlns:help="http://openoffice.org/2000/help"/>WEEKSINYEAR</p>
  94.    <p class="Paragraph">Calculates the number of weeks in a year until a certain date. The number of weeks is defined as follows: a week that spans two years is added to the year in which most days of that week occur.</p>
  95.    <p class="Head3">Syntax</p>
  96.    <p class="Paragraph">WEEKSINYEAR(Date)</p>
  97.    <p class="Paragraph">Date: The date until which the weeks in the year will be calculated.</p>
  98.    <p class="Head3">Example</p>
  99.    <p class="Paragraph">WEEKSINYEAR(17.02.70) returns 53.</p>
  100.    <p class="Head2"><a name="api"/>Add-ins via <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> API</p>
  101.    <p class="Paragraph">Add-Ins can also be implemented via the <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> API. You have to define a Service supporting com::sun::star::sheet::AddIn and register an implementation of it. You can get more information about <help:productname xmlns:help="http://openoffice.org/2000/help">%PRODUCTNAME</help:productname> API documentation for advanced users by requesting it.</p>
  102.   </body></html>